home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / info-service / gopher / PC_server / hamburg / announce < prev    next >
Encoding:
Text File  |  1993-06-14  |  5.7 KB  |  139 lines
  1.                                   GO4HAM
  2.                   The Hamburg Gopher Server for WINSOCK.DLL
  3.               Including a Full Text Search Engine
  4.                                  08-JUN-1993
  5.  
  6.                               (c) Gunter Hille
  7.                    Comp. Science Dept., University Hamburg
  8.                        hille@informatik.uni-hamburg.de
  9.  
  10.  
  11. Here comes a PC Gopher server for MS-Windows. Before you start 
  12. downloading, make sure that you have a WINSOCK.DLL from one of the
  13. vendors. The server will not work without it!
  14.  
  15. This is a port of the Hamburg PC Gopher server which was released in
  16. February 1993. Due to an unsolved problem with the UoM TCP/IP package
  17. (which works fine when connecting PC clients) I decided to switch to
  18. the Windows socket library.
  19.  
  20. My thanks goes to Netmanage Inc., I downloaded their WINSOCK.DLL just
  21. six hours before the license expired (European time, of course).
  22. And thanks to MS-DOS from Microsoft Inc., it allowed me to set the date
  23. of my PC to the day before expiry. Until Lanera Corp. sent me a demo
  24. version of their WINSOCK.DLL without this time limit, I did not grow older.
  25.  
  26. That's why the server has been tested against two WINSOCK implementations.
  27.  
  28. The server is written in Borland Pascal for Windows(BP-7). Marc B. Manza's
  29. definition of the API calls was very helpful.
  30.  
  31. You will find the package at the Univ. Hamburg anonymous ftp server
  32.  
  33.     ftp.informatik.uni-hamburg.de/pub/net/gopher/pc/go4ham
  34.  
  35. You can let the server execute ANY program which is just doing 
  36. output to the standard output device and which does not expect character
  37. input from the keyboard. Be sure to run Windows in 386 enhanced mode.
  38. See the example selector strings in the root gopher file *.GOP
  39.  
  40. These directories are included in the package:
  41.  
  42. DOC        Documentation of this package
  43. SERVER        The Go4ham Gopher Server
  44.  
  45.  
  46. Improvements to the DOS version:
  47.  
  48. Search Engine:
  49.   The search engine can be used by the PC server as well. I will release
  50.   a new version of the PC server within the next month (then it will
  51.   hopefully send to all UNIX clients).
  52.   To understand the search engine you have to read the small documentation
  53.   accompanying the programs. The system is a patchwork, but I could take
  54.   most of the parts from programs I had developed a year ago.
  55.   If more than one keyword appears in the search string, this implies a
  56.   logical AND. The wildcard character is a "*" at the end of a word.
  57.   Seek time is approx. 3 seconds per keyword if 5MB (2000 documents) are
  58.   indexed (measured under DOS on a 386SX-33). Indexing is slower, approx.
  59.   500 KB/h (under DOS). Windows reduces these times drastically, as expected.
  60.  
  61. Secure server mode: 
  62.  
  63. 1. You have to specify the names of the programs which will be executed by 
  64.    the server. Create a file GOPHPROG.DAT and specify the names, each name
  65.    on a separate line (without extension).
  66.  
  67. 2. No access to files above the working directory. You have to specify
  68.    the working directory in the command line. Using a wildcard "*" will
  69.    allow access to all files on your computer, be sure to use it in a safe
  70.    environment! 
  71.  
  72. Character translation:
  73.  
  74.    You may configure the server to translate characters to different
  75.    character sets (I will add ISO to ASCII and IBM later, there is no
  76.    need here at home, I do just have IBM code text files).
  77.  
  78.    - RAW   : no translation
  79.    - ISO   : ISO Latin 1 as specified in the Gopher protocol
  80.    - ASCII : translate IBM character set to 7 bit ASCII
  81.          (as single characters are expanded to two or three characters,
  82.          tabular output may be corrupted).
  83.  
  84. Logfile:
  85.  
  86.    The logfile is in the QED format as all other database files. Date, time,
  87.    Internet address of the caller, and the requests are logged to the file
  88.    GOPHSERV.LOG.
  89.  
  90.  
  91. Bugs:
  92.  
  93.  - Probably lots of them. The server was tested at home and has never been
  94.    tested on the Internet (our PCs load their Windows system from a mainframe,
  95.    using Digital Equipment's PCSA, so you cannot run TCP/IP as well). But if
  96.    the Winsock API is a standard, there should be no problems.
  97.  
  98.  - All application programs have to send their results in a file with the
  99.    name RESULTS.PDX. This file will be send back to the client 
  100.    (being a Gopher directory or a text file). The server adds .<CR><LF> at
  101.    the end, if item types 1 and 7 are in the selector string.
  102.  
  103.  - Do not start other Windows applications while the server is executing
  104.    an application. The server can only synchronize with the completion 
  105.    of a task (waiting for RESULTS.PDX to appear) by checking the number 
  106.    of tasks in the system. This is not yet tested.
  107.    
  108.  - The server does not fork itself for multiple connections, because 
  109.    otherwise you could not execute DOS programs by the server and receive
  110.    the result in a special file. So only one connection is handled at a time.
  111.    But up to 5 waiting connections are allowed by the WINSOCK API.
  112.  
  113.  - the documentation is poor, I know. But I was too busy to get the server
  114.    working.
  115.  
  116.  - you cannot index files while the server is running (I didn't try it,
  117.    but I'm sure I have to use the new Paradox Engine for Windows instead
  118.    of the current one, which was programmed in Borland Pascal version 5.x)
  119.  
  120. History:
  121.  
  122. 24-APR-93: download of WINSOCK.DLL and WINSOCK.PAS from vax.ftp.com
  123. 25-APR-93: First try of Winsock API with Borland PASCAL 7.0
  124. 02-MAY-93: got my first TCP/IP test programs running
  125. 09-MAY-93: Gopher Server running with WINSOCK API
  126. 18-MAY-93: I added an icon and a small menu, now the code is approx.40 KB.
  127.        The icon is borrowed from the University of Minnesota,
  128.        the letters "HH" on the gopher's cap are an abbreviation for 
  129.        the city of Hamburg.
  130. 25-MAY-93: search engine added in the menu
  131. 10-JUN-93: Beta release of version 1.06
  132.  
  133.  
  134. Happy gophering,
  135.  
  136. Gunter
  137.  
  138. Please send bug reports and comments to:   hille@informatik.uni-hamburg.de
  139.